Configuration Service

AttendanceSettingsDto

This class contains information about the attendance list settings.

Datatype	Name	Description
bool	ShowStaffOnlyInCoverage	Flag indicating whether the attendance list shows all staff, or only staff that is in coverage
bool	FinishWorkByManuallyBooking	Flag indicating whether the end of work shall be retrieved by manually booking

AutomatedMailsDto

This class contains information about the automatic mail dispatch in TimePunch.

Datatype	Name	Description
MailReceiver	MailCoreTimeViolation	Defines to whom the core time violations shall be send
String	MailCoreTimeViolationToCustomMailAddress	Defines a custom mail address to whom the core time violations shall be send. It’s possible to define multiple addresses separated by comma.
MailReceiver	MailMonthEndClosing	Defines to whom the month end closings shall be send
String	MailMonthEndClosingCustomMailAddress	Defines a custom mail address to whom the month end closings shall be send. It’s possible to define multiple addresses separated by comma.
MailReceiver	MailTimeEntryAudit	Defines to whom time entry audits shall be send
String	MailTimeEntryAuditToCustomMailAddress	Defines a custom mail address to whom the time entry audits shall be send. It’s possible to define multiple addresses separated by comma.
MailReceiver	MailFireAndHire	Defines to whom fire and hire information shall be send
String	MailFireAndHireToCustomMailAddress	Defines a custom mail address to whom the fire and hire information shall be send. It’s possible to define multiple addresses separated by comma.
MailReceiver	MailFinishedWork	Defines to whom the finished work information shall be send
String	MailFinishedWorkCustomMailAddress	Defines a custom mail address to whom the finished work information shall be send. It’s possible to define multiple addresses separated by comma.

CalculationInternalsDto

Diese Klasse beinhaltet Einstellungen zur internen Berechnungslogik von TimePunch.

Datatype	Name	Description
ContinuedPayment	LeavePayoutCalculation	Defines how the continued leave payout will be calculated (AsWorkTime, AsAveragePayout)
ContinuedPayment	SickPayoutCalculation	Defines how the continued sick payout will be calculated (AsWorkTime, AsAveragePayout)
ContinuedPayment	BankHolidayPayoutCalculation	Defines how the continued bank holiday payout will be calculated (AsWorkTime, AsAveragePayout)
Bool	IsDataPreview	Defines, if a data preview shall be activated. With activated data preview, the times will be calculated ahead for the current month.
DateTime?	OverbookingIsAllowedSince	Defines, if overbooking is allowed and since when it is allowed.
double?	OvertimeSurchargeStart	Defines the start of the overtime surcharge. If not defined the surcharge time starts with the target time of the user.
ShortTimeWork	ShortTimeWork	Defines how short time work shall be handled (PerDay, PerMonth)
OvernightEntries	OvernightEntries	Defines how overnight entries shall be displayed to the user (Split, Merge)
bool	IsDayPartRounded	Flag that defines whether the day part calculation gets rounded

CostCenterDto

This class contains information about the cost center assignment of the different booking types in TimePunch.

Datatype	Name	Description
String	SicknessCostcenter	Cost center that is used for sickness bookings
String	LeaveCostcenter	Cost center that is used for leave bookings
String	OfficialBankHolidayCostcenter	Cost center that is used for official bank holiday bookings
String	SpecialLeaveCostCenter	Cost center that is used for special leave bookings
String	CorrectionCostCenter	Cost center that is used for overtime/flexitime corrections

SalaryExportDto

This class contains information about the settings for wage data export.

Datatype	Name	Description
String	FixedSalaryTypeNo	Defines the account for the fixed salary export.
String	TemporaryHourlyWageTypeNo	Defines the account for the temporary hourly wage workers.
String	HourlyWageTypeNo	Defines the account for the hourly wage workers.
String	SicknessTypeNo	Defines the account for the time of sickness.
String	LeaveTypeNo	Defines the account for the leave time.
String	SpecialLeaveTypeNo	Defines the account for the special leave time.
String	PaidOvertimeTypeNo	Defines the account for the paid overtime.
String	OfficialBankHolidayTypeNo	Defines the account for the official bank holiday.
String	PaidOfficialBankHolidayTypeNo	Defines the account forfor the paid official bank holiday work time
String	SaturdayWorkAmTypeNo	Defines the account for the work at Saturday morning.
String	SaturdayWorkPmTypeNo	Defines the account for the work at Saturday afternoon.
TimeSpan	SaturdaySplitTime	Time that separates the saturday morning of the saturday afternoon.
String	SundayWorkTypeNo	Defines the account for the worktime at Sunday.
String	NightShiftTypeNo	Defines the account for the night shift working time.
String	NightShiftCoreTypeNo	Defines the account for the night shift core working time.
TimeSpan	NightShiftStartTime	Start time of the night shift
TimeSpan	NightShiftEndTime1	End time of the core night shift.
TimeSpan	NightShiftEndTime2	End time of the extended night shift.
String	OvertimeTypeNo	Defines the account for the overtime
String	OnCallServiceTypeNo	Defines the account for the on-call service
String	ShortTimeWorkTypeNo	Defines the account for the short time work.
String	SicknessNotPaidTypeNo	Defines the account for the sick days that are not paid
string	MorningShiftTypeNo	Defines the account for the morning shift time
TimeSpan	MorningShiftStartTime	Defines the start time for the morning shift
TimeSpan	EveningShiftEndTime	Defines the end time for the morning shift
string	EveningShiftTypeNo	Defines the account for the evening shift time
TimeSpan	EveningShiftStartTime	Defines the start time for the evening shift
TimeSpan	EveningShiftEndTime	Defines the end time for the evening shift

GlobalSalaryExportDto: SalaryExportDto

This class contains information about the global settings for export to a connected payroll accounting system.

Datatype	Name	Description
SalaryExportTarget	ExportTarget	Defines to which system the data shall be exported (DatevLODAS, DatevLohnUndGehalt, LexwareLohnUndGehalt, SBSLohnPlus)
SalaryExportType	ExportType	Defines the type of the salary export. SimplePayout The complete month gets exported SubsequentPayout Export in the middle of the month using DATEV retroactive billing FloatingPayout Export in the middle of the month without using the DATEV recalculation
String	StatisticLeaveAsDays TypeNo	Defines the statistic type no for taken leave
String	StatisticSickAsDaysTypeNo	Defines the statistic type no for sick days
String	StatisticRemainingLeave AsDaysTypeNo	Defines the statistic type no for remaining leave days
String	StatisticWorkAccount TypeNo	Defines the statistic type no for the working account
Bool	StatisticLeaveAsDays TypeNoChecked	Defines, if the statistic value for leave as days shall be exported
Bool	StatisticSickAsDays TypeNoChecked	Defines, if the statistic value for sick days shall be exported
Bool	StatisticRemainingLeave AsDaysTypeNoChecked	Defines, if the statistic value for remaining leave as days shall be exported
Bool	StatisticWorkAccountType NoChecked	Defines, if the statistic value for the working account shall be exported
Bool	BookMissingButPaidWorkTimesToPaidOvertime	If true, missing work time that gets paid, will be booked as paid overtime

UserSalaryExportDto: SalaryExportDto

This class contains information about the global settings for export to a connected payroll accounting system.

Datatype	Name	Description
Guid	UserId	Id of the user
TimeSpan?	NightShiftStartTime	Start time of the night shift
TimeSpan?	NightShiftEndTime1	End time of the core night shift.
TimeSpan?	NightShiftEndTime2	End time of the extended night shift.
TimeSpan?	SaturdaySplitTime	Time that separates the saturday morning of the saturday afternoon.
TimeSpan?	MorningShiftStartTime	Start time of the morning shift.
TimeSpan?	MorningShiftEndTime	End time of the morning shift.
TimeSpan?	EveningShiftStartTime	Start time of the evening shift.
TimeSpan?	EveningShiftEndTime	End time of the evening shift.

UserSettingsDto

This class contains settings for the behaviour of TimePunch.

Datatype	Name	Description
Bool	IsAllowedToOverwriteBreaks	Flag that indicates whether a break can be overwritten by user with restricted access. This value is false by default, because we do not want the user (without the managing permissions) to do that.
String	IsAllowedToManageProjectAccess	Flat that indicates whether the timepunch user can manage project access. This value is true by default. It may only be false if the project access gets managed by a 3rd party software
Bool	DisableCreationOfMasterdataDuringImport	Flag that prevents the creation of master data during import, if master data is missing in import file.
ProjectAvailability	ProjectAvailabilityForNewProjects	This field defines the default availability for new created projects.
FullNameMode	FullNameMode	The full name mode defines the ordering of the employee names. e.g. 'firstname lastname' or 'lastname, firstname'

DocumentStoreConfigurationDto

This class contains the configuration of the document store in TimePunch.

Datatype	Name	Description
int	MaxDatabaseSizeGB	Maximum size of the document storage.
int	MaxFileSizeMB	Maximum file size of one PDF Document stored in the document storage.

VisualSettingsDto

This class contains the configuration of the UI settings.

Datatype	Name	Description
TimeEntryCheckbox	TimeEntryCheckboxes	Defines the visible checkboxes at the time entry dialog
bool	DefaultShowAccountingDetails	True, if the project accounting details shall be visible to the user
bool	DefaultIsDescriptionMandatory	True, if the describtion of a time entry field is mandatory

RetroactiveProjectAssignmentDto

This class contains the settings for the retroactive project assignment of the working time.

Datatype	Name	Description
Guid	DefaultAccountingProjectId	The default project id that is used for project accounting
int	DaysForRetroactiveAssignment	The amount of days for which is the retroactive accounting open for
int?	RemindUserAfterDays	The timespan in days after that the user gets a reminder
int?	InformProjectLeadAfterDays	The timespan in days after the team leader gets informed
int	MinimumUnassignedTimeInMinutes	The minimum unassigned time in minutes
bool	IsDefaultBreakProjectAllowed	If true, users are allowed to book break times for the retroactive accounting